home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 24 / CU Amiga Magazine's Super CD-ROM 24 (1998)(EMAP Images)(GB)(Track 1 of 2)[!][issue 1998-07].iso / CUCD / Utilities / afortune / AFortune.doc < prev    next >
Text File  |  1992-06-05  |  6KB  |  159 lines
  1.  
  2.                                 AFortune 2.0
  3.  
  4.                                  5-Jun-1992
  5.  
  6.                             ©1992 by Ives Aerts
  7.  
  8. 0.Preface
  9. =========
  10.  
  11.    One of the (few) things I like about the I*M mainframe at our university
  12. is  the  fortune  cookie program.  I liked them so much that I wrote my own
  13. fortune  cookie  program  for  the  Amiga and collected a large database of
  14. fortunes.   In  the  meantime  I upgraded to 2.0 and other fortune programs
  15. became  available,  but  none  of  them suited me so I wrote a 2.0 specific
  16. version.
  17.  
  18. 1.Features
  19. ==========
  20.  
  21.    Why  would anyone want yet another fortune cookie program ?  Here's some
  22. reasons:
  23.  
  24.    · has a LARGE database of fortunes (±1.2 Mb uncrunched, ±600K crunched)
  25.    · ability to crunch fortune files (save hd space)
  26.    · uses multiple fortune files (faster)
  27.    · fortunes in CLI window or nicely centered in a window on the workbench
  28.    · custom font usable
  29.    · ability to show last fortune again (or trace it back in the database)
  30.  
  31. 2.Legal status
  32. ==============
  33.  
  34.    AFortune  2.0  is  (c) 1992 by Ives Aerts and may only be distributed in
  35. its  complete,  unmodified  form  (program and docs).  Distribution is only
  36. allowed in a non-profit way.
  37.  
  38.    This  program is shareware.  If you like and/or use this program I would
  39. appreciate  it  if  you  send  me  a contribution of $10 or 300Bfr (Belgian
  40. Francs).   Please  send  money  by international money order, EuroCheck (in
  41. Belgian  Francs) or cash, 'cos it's quite expensive for me to cash in other
  42. checks.  My address can be found at the end of the document.
  43.  
  44.    I  went  through  a  lot of trouble collecting and editing the database,
  45. (collecting from different sites, removing duplicate entries, converting to
  46. a  usable  format,  etc.)  but the fortune files are public domain.  If you
  47. want  to  use  them yourself then please mention me in your document and/or
  48. consider paying me a shareware contribution for the effort I made.
  49.  
  50. 3.System requirements
  51. =====================
  52.  
  53.    To  run  AFortune you'll need OS 2.04 or higher, powerpacker.library and
  54. reqtools.library  (included  in the package).  Due to a bug in dos.library,
  55. the  'last'  and  'setenv'  options are only usable with dos.library V37 or
  56. higher  (you  can  find out which version you have by executing the command
  57. 'version dos.library').
  58.  
  59. 4.Usage
  60. =======
  61.  
  62.    AFortune can be run from workbench or from the CLI. Just drag it in your
  63. WBStartup drawer to get a random fortune each time you start up.
  64.  
  65.    Following tooltypes and/or CLI arguments are available:
  66.  
  67. · LAST   - repeats the last fortune (see section 5).
  68. · SETENV - remembers the current fortune (see section 5).
  69. · WAIT   - (only  available  from  the  CLI)  Waits  for  a keypress  after
  70.             displaying the fortune.
  71. · WINDOW - use  a  borderless  window  centered  on the visible part of the
  72.             workbench  to  display  the  fortune in. Clicking in the window
  73.             will make it dissapear.
  74.  
  75. . ?      - (CLI only) display argument template.
  76. . ??     - (CLI only) display usage.
  77.  
  78. · FONT=fontname.font
  79.   SIZE=fontsize
  80.          - display the fortune in the specified font. Note that this forces
  81.             the fortune to be displayed in a window and that both arguments
  82.             (font name and size) must be specified.
  83.  
  84. · DIR=dirname
  85.          - look  for  the  data files in the designated directory. When not
  86.             specified,  AFortune  will  look  for data files in the current
  87.             directory. Data files are recognized by their '.frt' extension.
  88.  
  89. · CNT=number
  90.          - use the data files named '01.frt' to 'number.frt' where number is
  91.             less than or equal to 99. When not specified, AFortune will have
  92.             to scan the directory for files ending in '.frt', which may take
  93.             some time.
  94.  
  95. 5.Environment variables
  96. =======================
  97.  
  98.    When  the 'setenv' switch is specified, AFortune will set two environment
  99. variables to remember the current fortune.  'Fortune_file' contains the name
  100. of  the file that contains the last fortune.  'Fortune_offset' is the binary
  101. offset  in  that file of the last fortune.  You can use these to look up the
  102. fortune  in  the database yourself (use 'getenv' to read the contents of the
  103. environment  variables)  or  use  the  'last'  switch  to  force AFortune to
  104. redisplay the last fortune.
  105.  
  106. 6.Datafile format
  107. =================
  108.  
  109.    The datafiles are the files with the .frt suffix.  These can be crunched
  110. with   Nico   François'  excellent  PowerPacker  to  save  diskspace.   The
  111. decrunched  files  consist  of  the  fortunes, separated with a ¤ character
  112. (ascii 164, alt-y).  The files must begin and end with that character.  You
  113. can  make  them as long as you wish but longer files will take more time to
  114. decrunch.
  115.  
  116.    If  you  add one or more data files with new fortunes then please send a
  117. copy of them to me.
  118.  
  119. NOTE:
  120.  
  121.  · the  ¤  character  HAS  to  be the last character of the fortune file so
  122.     don't put a carriage return after it !
  123.  
  124.  · unless  you use the 'count' option, this program will try to use ALL the
  125.     files  with  suffix  .frt  from  the  directory you specify (or current
  126.     directory).  So  make  sure  you  don't  have any other files with that
  127.     suffix or you may get a lot of garbage on your screen.
  128.  
  129. 7.Contacting the author
  130. =======================
  131.  
  132.    If  you  have any comments about this program then don't hesitate to let
  133. me know. I can be reached until october '92 via e-mail on:
  134.  
  135.                         GHGAGAA at BLEKUL11.BITNET
  136.                         ghgagaa@cc1.kuleuven.ac.be
  137.  
  138. My snail mail address:
  139.                                 Ives Aerts
  140.                               Bareelstraat 36
  141.                                2300 Turnhout
  142.                                   Belgium
  143.                                   Europe
  144.  
  145.  
  146. ***************************************************************************
  147.  
  148. I hope you enjoy the program ...
  149.  
  150. ©1992 Ives Aerts
  151.  
  152. "she's walking in between you
  153. she walks
  154. circle
  155. spins around you
  156. she lives
  157. on
  158. looks"  Pools in eyes - Throwing Muses
  159.